home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / fill14.arc / FILL.DOC next >
Text File  |  1987-05-23  |  8KB  |  186 lines
  1.  
  2. FILL.DOC: documentation for Fill v1.4
  3.           (c) Jean Lalonde, Montreal, Canada
  4.           May 23, 1987
  5.  
  6.           History
  7.           -------
  8.           v1.0 (Feb 23, 87):
  9.             First release.
  10.           v1.1 (Mar 17, 87):
  11.             This version accept a non-empty target floppy to copy the
  12.             files in sub-directories.  You can change, make or remove
  13.             directories on the target floppy.
  14.           v1.2 (Apr 13, 87):
  15.             This version allows to copy given files from various 
  16.             sub-directories down from a given directory.  Fill prompt
  17.             you if a file already exists on the target floppy.  You
  18.             can overwrite, rename or skip this file.
  19.           v1.3 (May 12, 87):
  20.             Correct a bug from v1.2.  Now, Fill will detect when the
  21.             target's root directory is almost full (maximum is 112 files).
  22.             When Fill counts 111 files, it prompt you to change the target
  23.             directory or the target floppy.  I also add in this version
  24.             a confirmation prompt before escape procedure.  From this
  25.             version, multiple file names separated by '+' are allowed.
  26.           v1.4 (May 23, 87):
  27.             Maximum number of files in root is automatically initialized 
  28.             from boot sector according to your disk drive type (maximum 
  29.             can be 64, 112, 512 or wathever future DOS compatible drives
  30.             manufacturers can define).
  31.             Remove prompt for a formatted diskette while loading program.
  32.             Option '/F' added to format immediately the first disk.
  33.             Correct a minor display bug in "O(ther / M(akeDir / Change to
  34.             this directory (y/N) ?" -> default in prompt was wrong.
  35.  
  36.  
  37.      Hi!
  38.  
  39.      Did you ever encountered this situation: you want carry the
  40.      files of a directory from one hard-disk to another.  You have to
  41.      copy the files of this directory to floppy disk.  The directory
  42.      contains several files, some big, other smaller, and...
  43.  
  44.           C>copy *.* a:
  45.           FIRSTBIG.EXE
  46.           OTHERBIG.EXE
  47.           Insufficient disk space
  48.                   1 File(s) copied
  49.  
  50.      You realize that you will have to copy your directory on more
  51.      than one floppy.  Then, you have two choices.  First, copy each
  52.      file seperately checking the space remaining on 'A:' and the
  53.      files size.  Second choice, you can use a back-up program.  The
  54.      backup program is a good solution but you will have to carry
  55.      the restore program with you.  With Fill, there is a third
  56.      solution...
  57.  
  58.           C>fill *.* a:
  59.  
  60.      Fill will copy all your files, filling up each floppy disk.  To
  61.      do this, Fill will build a list of the files of the directory,
  62.      sort this list by size order and then copy the biggest file to
  63.      the floppy.  Second, it will copy the biggest file that can be
  64.      copied in the remaining space of the floppy and so on. When the
  65.      first floppy will be filled up, Fill will prompt you for another
  66.      disk until the directory is completely copied to floppies.
  67.  
  68.      This way, Fill optimize your floppy disk space, make the job easy
  69.      and keep your files in their original-executable format.  To
  70.      restore the files on the destination hard-disk, all you will have
  71.      to do is copying the files of each floppy with the simple
  72.      command...
  73.  
  74.           A>copy *.* c:\directory
  75.  
  76.      Fill calculate the number of floppies needed before beginning
  77.      the job.  You will never have to stop because you do not have
  78.      enough floppies.  Fill will also allow you to list files (dir),
  79.      delete or format the destination floppy without leaving the
  80.      program.  You can also change, make or remove directories on the
  81.      target floppy.
  82.  
  83.      The only restriction is that the biggest file of your directory
  84.      must fit on one floppy (362,496 bytes or 1.2 meg according to
  85.      your configuration).  If the biggest file do not fit on a floppy
  86.      you will have to use the backup/restore solution.
  87.  
  88.      To allow formatting within Fill, the program FORMAT.COM (or
  89.      FORMAT.EXE) must be in your PATH directory.  If FORMAT is in the
  90.      directory '\DOS', your AUTOEXEC.BAT file must specify:
  91.  
  92.           PATH=C:\DOS;...other directories...;
  93.  
  94.      The Fill's syntax is very similar to the copy's syntax:
  95.  
  96.           Fill \directory\files target [/f] [/m] [/s]
  97.  
  98.           '\directory' is the directory to copy
  99.           'files' to copy (wild cards allowed, default is '*.*',
  100.              multiple file names such '*.COM+*.EXE' allowed)
  101.           'target' is the destination drive (must be 'A:' or 'B:')
  102.           '/F' to format the first target disk automaically
  103.           '/M' to copy all matching files down from the given directory
  104.           '/S' to repeat the task on sub-directories
  105.  
  106.      When Fill is called, it start immediately, reading the target
  107.      floppy disk to get the disk type and its free space.  A formatted
  108.      disk must be inserted in the target drive.  If you do not have
  109.      a formatted fisk, you can insert a new disk and use the option
  110.      '/F'.  Fill will first prompt you for a disk to format.
  111.  
  112.      If you get the error message:
  113.  
  114.        Not ready error reading drive A
  115.        Abort, Retry, Ignore?
  116.  
  117.      You did not insert a disk in the target drive (here 'A:').
  118.      Insert a formatted disk and press 'R' to retry.
  119.  
  120.      If you get the error message:
  121.  
  122.        General Failure error reading drive A
  123.        Abort, Retry, Ignore?
  124.  
  125.      You inserted a non-formatted disk in the target drive (here 'A:').
  126.      Insert a formatted disk and press 'R' to retry or press 'A' to
  127.      abort and call Fill with the oprion '/F'.
  128.  
  129.      The option '/S' allows you to repeat the process on every sub-
  130.      directories under the specified directory without repeating the
  131.      command line.
  132.  
  133.      The option '/M' allows to copy all files matching 'files' a given
  134.      directory and its children directories.  This command:
  135.  
  136.           C>fill \*.arc a: /m
  137.  
  138.      will copy all .ARC files on your hard-disk to floppies.  If a file
  139.      has the same name than another file already copied to the target
  140.      floppy, Fill will prompt you if you want to ovewrite the file
  141.      on the target floppy, if you want to give another name to the
  142.      second file copied or if you want to skip the second file.
  143.  
  144.      Caution: if two files with the same name are copied to different 
  145.      floppies, Fill will not prompt you.  In this case, take care when 
  146.      you will copy the floppies to another hard-disk.  If you use:
  147.  
  148.           A>copy *.* c:
  149.  
  150.      the second file will overwrite the first one.  There is no problem
  151.      if those files are duplicated but if different files have the same
  152.      name, you may lost the second.  To avoid this, use DDup to identify
  153.      duplicated files to rename files before filling (see OTHERS.DOC) 
  154.      or Xcopy (DOS 3.2 and later) instead of Copy.  Xcopy will prompt 
  155.      you before overwriting a file on the target disk.
  156.  
  157.      I hope Fill will be usefull to you.  You can send me comments or
  158.      reports to:
  159.  
  160.           Jean Lalonde
  161.           P.O. BOX 721
  162.           Station "R"
  163.           Montreal
  164.           CANADA
  165.           H2S-3M4
  166.  
  167.      You can join me online on Compuserve (ID: 76606,671) or on BIX
  168.      Info Exchange (Bix name: jlalonde).  Fill is written in MODULA-2/86
  169.      Rel. 2.0 (A), PC/MS-DOS 8088/8086, LOGITECH, (C) Copyright 1983,
  170.      1984, 1985, 1986.  Fill uses standard BIOS and PC/MS-DOS functions,
  171.      v3.0 or more.  It support redirected input/output: you can send output
  172.      to the printer ("Fill dir\*.* D: >PRN") or use Fill through a modem.
  173.      The larger your RAM is, the faster Fill will copy your files. Although
  174.      it will run correctly with only 100k of RAM free.
  175.  
  176.      You can use or redistribute this program freely as long as it is
  177.      done at no cost (except floppy's cost) if this documentation file
  178.      and the copyright remain intact.  Modula-2 sources of this
  179.      program are available.  To receive those text files, please send
  180.      me a $25 check.
  181.  
  182.      Enjoy Fill!
  183.  
  184.      Jean Lalonde
  185.      May 23, 1987
  186.